Peter’s Player is an application designed to play QuickTime movies as smoothly as possible, automatically. Just drag a movie onto the Peter’s Player icon from the Finder, or choose one through the “Open…” menu, and the movie will start playing as smoothly as your Mac can manage.
Peter’s Player uses every method available to get the best playback performance from each movie. It will load the entire movie into RAM if possible, determine the monitor depth the movie was intended for, automatically set your monitor to the closest depth to the ideal that it supports, and hide the standard QuickTime movie controller to eliminate the overhead it introduces. Peter’s Player also provides an option to force every frame of a movie to be displayed, no matter how slow the system, or how large the movie (the movie’s soundtrack will not be played when this option is chosen, though). For optimal dramatic impact (and to make output to video easier), movies are displayed against a black background. You can even hide the menu bar, for total QuickTime immersion!
Finally, Peter’s Player is “accelerated for Power Macintosh,” meaning it runs at the highest possible speed on either 68k or Power Macintosh computers.
Peter's Player is Shareware. You can use it free of charge for 30 days. After that time, if you would like to continue using it, please send $10 in U.S. funds to the author.
System Requirements
Peter’s Player requires a Macintosh with a 68020 or later 68k processor or a Power Macintosh, System 7.0 or later, the QuickTime™ system extension, and at least 512K of free RAM. 2048K of free RAM and QuickTime version 2.1 or later are recommended.
The Playback Menu
The Playback menu contains options that control how the current movie is displayed. The options are:
Show/Hide Menus
Causes the menu bar to be “blacked out.” Even when the menu bar is hidden, it is still available: just click where it would normally be and it will appear.
If you have multiple monitors, Peter’s Player will use the one set to the highest bit depth when the program was launched. If that is not the monitor that has the menu bar, this menu option will be dimmed.
Show/Hide Controller
Causes the standard graphical QuickTime movie “controller” to appear under the movie (or to be hidden if it was showing). Documenting the operation of the controller is beyond the scope of this manual, but most of the controls are pretty self-explanatory. Movies may play back a little less smoothly when the controller is showing, because the system must use some of its resources to update the controller as the movie plays.
Loop
If this option is checked, when the open movie reaches its end, it will immediately start playing again from the beginning.
Loop Back and Forth
If this option is checked as well as the “Loop” option, when the open movie reaches the end, it will play backwards until it reaches the beginning, then forwards ‘til the end, …
Half Size
Causes the movie to be played back at half it’s default width and height.
Normal Size
Causes the movie to be played back at the width and height intended by the movie’s creator(s).
Double Size
Causes the movie to be played back at twice it’s default width and height.
Fill Screen
Causes the movie to fill the entire screen. Because of the uneven scaling necessary to make most movies fill most screens, playback quality is likely to be quite poor when this option is used. Whenever possible, use the “Double Size” option to make your movies larger instead of this option.
Play Every Frame
Forces QuickTime to display every frame of a movie, even if it means playing the movie back more slowly than intended. When this option is checked, the movie will play silently, whether or not it has a soundtrack. If the movie has only sound, though, and no video, this option will be ignored, allowing you to listen to the movie anyway.
Set Monitor to Best Depth
When this option is checked, Peter’s Player will examine each movie it opens to see what monitor depth it was intended to be played on, and will set your monitor to that depth (or the closest match it supports) before playing the movie. When you exit Peter’s Player, your monitor will be set back to the depth it was at when you started the program. If you switch to another application, Peter’s Player will restore your original bit depth until you return.
Preferences
Preferences control the way Peter’s Player behaves each time you launch it, and whenever you open a new movie. Changes made while a movie is open will not affect that movie, instead they will take effect when you open a new one.
Can’t Load Into RAM (Warning)
When this preference is checked (the default), if the “Load Into RAM” option is also checked and there is not enough RAM to load a movie in its entirety, you will be given a warning dialog telling you so. If “Load Into RAM” is checked but this preference is not, you will not be warned when a movie could not be completely loaded. In either case, the movie will play smoothly until the portion that was successfully loaded into RAM ends, but may become jerky after that, as the rest of the movie must be loaded from disk as it is played.
Can’t Play Soundtrack (Warning)
When this preference is checked (the default), if the “Play Every Frames” preference has also been checked and you open a movie that has a music or sound track as well as video, you will be warned that the sound won’t be played unless the “Play Every Frame” option is disabled.
Hide Menu Bar
When this preference is checked, Peter’s Player will start with the menu bar hidden (as long as the monitor with the menu bar is the one set to the highest bit depth—see the “Show/Hide Menus” description in the Playback Menu section for more details).
Load into RAM
When this preference is checked, Peter’s Player will try to load each movie into RAM before playing it. This yields the smoothest possible playback, but it increases the time it takes large movies to load. If you are using Virtual Memory, you will get the best performance from this option if you allocate less than the amount of physical RAM in your machine to Peter’s Player. If you attempt to load a movie that requires more RAM than you have allocated to Peter’s Player, as much of the movie as will fit will be loaded into RAM. In this case the movie will start to play back smoothly, but may become jerky once the buffered portion has finished and the rest must be loaded from disk as it is played.
Loop
When this preference is checked, newly opened movies will play in a continuous loop. If it is not checked, each movie will stop when it reaches its end.
Play Every Frame
When this preference is checked, movies will open in “Play Every Frame” mode. See the description of this option in the Playback Menu section for more details.
Play Immediately
When this preference is checked, movies will start to play as soon as they are opened. If it is not checked, movies will open paused on the first frame, and you will have to make them start playing yourself.
Quit After Playing
When this preference is checked, Peter’s Player will quit as soon as a movie ends or is paused. If the movie is set to loop, Peter’s Player will not quit until the movie is manually paused. This option should allow Peter’s Player to be used to play movies in conjunction with packages like NCSA Mosaic or HyperCard. It can also be used to make movie browsing easier. In most cases, you will want to turn “Play Immediately” on, and “Loop” off when using this option.
Set Monitor to Best Depth
When this preference is checked, Peter’s Player will try to determine the best monitor depth to play each movie back at, and adjust your monitor accordingly. See the description of the “Set Monitor to Best Depth” option in the Playback Menu section for more details.
Show Controller
When this preference is checked, the standard QuickTime movie controller will be visible under each newly-opened movie.
Shortcuts
Opening movies
In addition to opening movies from the “Open…” menu item, you can drag the icon of a movie you’d like to open onto the Peter’s Player icon in the Finder and let go. If you do, Peter’s Player will open the movie immediately.
Keyboard and Mouse Shortcuts
These shortcuts work whether or not the movie controller is visible:
Move forward one frame: right arrow
Move back one frame: left arrow
Go to beginning of movie: option-click left arrow
Go to end of movie: option-click right arrow
Play backwards: command-left arrow
Play/pause: space bar or return key
Play: double click on the movie
Pause: single click on the movie, press command-‘.’ (period)
Increase the volume: up arrow
Decrease the volume: down arrow
Controller Shortcuts
These shortcuts work only when the movie controller is visible:
Adjust playback speed and direction: control-click either step arrow
Go to beginning of movie: option-click Step Backward arrow
Go to end of movie: option-click Step Forward arrow
Play backwards: option-click Step Backward arrow
Turn sound on or off: option-click the speaker icon
QuickTime Playback Primer
QuickTime is the name of a system created by Apple Computer to manage data that changes over time. A collection of QuickTime data is called a QuickTime movie. QuickTime currently runs on a number of operating systems, including Mac OS, Windows, Windows '95, Windows NT, and some flavors of Unix. Two types of data that QuickTime handles particularly well are video and sound: it includes routines to compress video and audio information and play them back in “real time,” even on relatively slow computers. Perhaps unfortunately, QuickTime is flexible enough that it is easy to create movies that cannot be played back smoothly on most (or indeed any) current computer hardware.
When QuickTime plays a movie, it does its best to play the movie at the rate the movie-maker intended (typically measured in frames-per-second for video). If a movie has both sound and video, it is particularly important that they both play back at the same rate so that everything happens “in sync.” When a movie contains too much information for the computer to display at the intended pace, QuickTime skips over some of the data, so that what is played back is played at the right time. (When skipping data, QuickTime drops video frames more readily than it drops sound).
In many cases, QuickTime skips frames of video so rarely that the viewer doesn’t notice the loss. When a movie is much too complex for the computer system it is being played on, though, so many frames must be dropped that the movie becomes visibly “jerky,” and the sound starts to break up.
Some of the major factors that govern how smoothly a movie will play back on a given system are:
•The speed of the system’s Central Processing Unit (CPU).
•The medium the movie is being played back from (it is much harder to get good playback from a floppy disk than from a high-speed hard disk array or a RAM disk…)
•The dimensions of the movie (the greater the dimensions, the larger the amount of data that must be copied to the computer screen for each frame of video, and the harder QuickTime must work to keep up).
•The “color depth” (number of bits per pixel) of the movie. QuickTime does a particularly good job displaying movies in 256 colors and “thousands of colors.” Movies generally play best when displayed on a monitor set to the depth they were compressed for.
•The intended playback rate (a movie recorded at 10 frames per second will play back without drop-outs on more systems than one recorded at 30 fps).
•The presence of a soundtrack (movies without soundtracks generally play back more smoothly).
•The compressor used to compress the movie (different compressors offer trade-offs of image quality vs. file size vs. playback speed).
Peter’s Player gets around slow movie media by attempting to load each movie into RAM before playing it. It also detects the bit depth which a movie was intended to be played back at, and sets your monitor to that depth (or the closest approximation it supports). Because of the other factors mentioned above, though, it is possible that some QuickTime movies will still stutter or suffer from significant numbers of dropped frames on your system, even when played back in Peter’s Player. In these cases, Peter’s Player gives you the option of forgetting about the soundtrack and just displaying every frame of the movie in turn, as close to the intended playback rate as possible.
License
Peter’s Player is Shareware. It may be used free-of-charge by any individual for 30 days. Individuals wishing to continue using the software more than 30 days after their first use must pay the author of the software,
Peter E. Lee, the sum of $10 (10 dollars) in US funds (see the section Contacting The Author, below, for more information).
Copies of Peter’s Player may be freely distributed in any medium, so long as: the Peter’s Player application is unmodified, the original documentation is included with the software, and no fee is charged for such copies or for any product they are included with, beyond the costs of media, shipping, and handling.
Any use or manner of distribution not explicitly described by this license is prohibited without the written consent of Peter E. Lee.
The software is delivered “as is,” and carries with it no warranties, either express or implied.
Contacting The Author
If you would like to register your copy of Peter’s Player, please send $10 in US funds to:
Peter E. Lee
9 Hazen St.
Chelmsford, MA 01824-4601
USA
For the fastest possible notice of upgrades and other Peter’s Player news, please include your e-mail address with your correspondence.
For information on commercial or site licenses, or if you have any questions, comments, or requests, I can be reached at the address above, or on-line at:
peters_player@pobox.com
Acknowledgments
Several people provided suggestions, testing, and encouragement without which Peter’s Player would not be in your virtual hands now. They are (in alphabetical order): Bill Bachman, Drew Cohan, Andrei Herasimchuk, David Hirmes, Chris Johnston, Adam Lavine, Lincoln Lydick, David Merck, Dan Sroka, David Trescot, Dennis Wilkinson, and Paul Young. Thanks folks!
Special thanks are also due to Dave Merck for the cool icon, to Specular International, Ltd. for allowing me to use their computers and compilers to build the Power Mac portion of Peter’s Player, and for allowing their employees, myself included, to test it, to the QuickTime team at Apple, for developing such a cool piece of software, and to everyone who has registered their copy of Peter's Player!
Revision History
Version 1.3 (5/4/98):
Fixed incompatibility with MacOS 8.1.
Further improvements to "Play Immediately" mode other optimizations.
Included sample AppleScript.
Version 1.2 (8/15/96):
Added hooks for internationalization.
Improved performance of "Play Immediately" mode.
Added support for movies with custom color tables.
Fixed possible memory corruption when quitting with QuickTime 2.5 installed.
Made various optimizations to the code to improve overall performance.
Updated author contact information.
Updated manual, moved “TroubleShooting” section into separate FAQ document.
First shareware version.
Version 1.1 (10/21/94):
Added "Quit After Playing" preference.
A progress bar is now displayed while loading large movies into RAM.
The menu bar no longer obscures the tops of tall movies when hidden.
Movies with only sound and/or music tracks can now be heard regardless of the setting of the "Play Every Frame" preference.
Clicking in the menu bar area when the menu bar is hidden should bring up the menus regardless of the height of the open movie.
Now issues a warning when movies with soundtracks are opened when the "Play Every Frame" preference is on.
Added "Can’t Load Into RAM" and “Can’t Play Soundtrack” warning preferences.
New U.S. mail address in the credits dialog and documentation.
Version 1.0.1 (7/17/94):
Movies that have been loaded into RAM and are set to loop will now stay in RAM until closed (or a new movie is opened) under QuickTime 2.0.
When the "load into RAM" preference is on and there is not enough RAM to load a particular movie, the portion of the movie that was loaded successfully will stay in RAM for smoother playback of that section.
It is no longer necessary to quit and re-launch the program to make changes to the "looping" preference take effect.
On machines with multiple monitors, there should no longer be a pause in playback shortly after a movie set to "play immediately" starts to play.
Peter's Player now gives more time to other applications when it is running in the background or when no movie is open.
